Глобальный контекст.ПоказатьВопрос (Global context.ShowQueryBox)

Глобальный контекст (Global context)

ПоказатьВопрос (ShowQueryBox)

Доступен, начиная с версии 8.3.3.

Синтаксис:

ПоказатьВопрос(<ОписаниеОповещенияОЗавершении>, <ТекстВопроса>, <Кнопки>, <Таймаут>, <КнопкаПоУмолчанию>, <Заголовок>, <КнопкаТаймаута>)

Параметры:

<ОписаниеОповещенияОЗавершении> (обязательный)

Тип: ОписаниеОповещения.
Содержит описание процедуры, которая будет вызвана после закрытия окна ввода значения со следующими параметрами:

<РезультатВопроса> - результат выбора пользователя: значение системного перечисления или значение, связанное с нажатой кнопкой. В случае закрытия диалога по истечении времени - значение Таймаут,
<ДополнительныеПараметры> - значение, которое было указано при создании объекта ОписаниеОповещения.

<ТекстВопроса> (обязательный)

Тип: Строка, ФорматированнаяСтрока.
Текст задаваемого вопроса.

<Кнопки> (обязательный)

Тип: РежимДиалогаВопрос, СписокЗначений.
Задает состав и текст кнопок диалога, а также, связанные с кнопками значения.
При использовании типа СписокЗначений:

Значение – содержит значение, связанное с кнопкой. Это значение является возвращаемым значением при выборе кнопки. В качестве значения может использоваться значение перечисления КодВозвратаДиалога, а также другие значения;
Представление – задает текст кнопки. Если представление не задано и в качестве значения используется значение перечисления КодВозвратаДиалога, то используется стандартное представление;
Картинка – не используется (должна быть пустой);
Пометка – не используется (должна быть пустой).

При использовании типа СписокЗначений список не должен быть пустым.

<Таймаут> (необязательный)

Тип: Число.
Интервал времени в секундах, в течение которого система будет ожидать ответа пользователя. По истечении интервала окно вопроса будет закрыто. Если параметр не указан, то время ожидания не ограничено.
Если параметр имеет отрицательное значение, будет сгенерировано исключение.
Значение по умолчанию: 0.

<КнопкаПоУмолчанию> (необязательный)

Тип: Произвольный.
Определяет кнопку по умолчанию по типу кнопки или по связанному с ней значению.

<Заголовок> (необязательный)

Тип: Строка.
Содержит заголовок окна вопроса.
Если не установлен, то у диалога заголовок не отображается.

<КнопкаТаймаута> (необязательный)

Тип: Произвольный.
Определяет кнопку (по типу кнопки или по связанному с ней значению), на которой отображается количество секунд, оставшихся до истечения таймаута.

Возвращаемое значение:

Результат выбора пользователя будет передан в метод, описанный параметром <ОписаниеОповещенияОЗавершении>.

Описание:

Выводит на экран окно вопроса, при этом не ожидается завершения ответа пользователя.

Доступность:

Тонкий клиент, веб-клиент, мобильный клиент, толстый клиент, мобильное приложение (клиент).

Примечание:

Ширина всех кнопок диалога одинакова и равна ширине самой широкой кнопки.
Ширина текста в диалоге ограничена 40 символами.

Пример:

Режим = РежимДиалогаВопрос.ДаНет;
Оповещение = Новый ОписаниеОповещения("ПослеЗакрытияВопроса", ЭтотОбъект, Параметры);
ПоказатьВопрос(Оповещение, НСтр("ru = 'Продолжить выполнение операции?';"
    + " en = 'Do you want to continue?'"), Режим, 0);
//...

&НаКлиенте
Процедура ПослеЗакрытияВопроса(Результат, Параметры) Экспорт
    Если Результат = КодВозвратаДиалога.Нет Тогда
        Возврат;
    КонецЕсли;

    //...

КонецПроцедуры

См. также:

Глобальный контекст, метод ПоказатьПредупреждение

Использование в версии:

Доступен, начиная с версии 8.3.3.

Описание изменено в версии 8.3.22.

Методическая информация